Agentic UI generator docs #3334
Conversation
IvanDanchev
force-pushed
the
agentic-ui-generator-docs
branch
from
5ad9c45 to
d69370f
Compare
ikoevska
left a comment
ikoevska
left a comment
There was a problem hiding this comment.
Usually, I'd hit approve but there are some outstanding issues that require more attention:
Your titles in the navigation are not rendering properly. Double-check your docs-builder.yml. Also, why is there a lonesome Copilot Extension article in the navigation?
The logical flow of the installation instructions requires some fixing. See my notes inside.
Due to the fact that index.md has been renamed to overview.md, docs-builder is now unable to resolve the directory paths without /overview in them. Consider adding redirects in docs-builder to handle this or rename them back to index.md.
|
|
||
| #### Visual Studio | ||
|
|
||
| 1. Log in with a valid [Telerik user account](https://www.telerik.com/account/). |
There was a problem hiding this comment.
This lacks proper context. Where should people log in? In Visual Studio or somewhere else? Consider the following change:
| 1. Log in with a valid [Telerik user account](https://www.telerik.com/account/). | |
| 1. In your browser, log into your [Telerik account](https://www.telerik.com/account/). |
| 5. Click **Generate Key**. | ||
| 6. Select **Copy and Close**. Once you close the window, you can no longer copy the generated key. For security reasons, the **API Keys** page displays only a portion of the key. | ||
| 7. Store the generated NuGet API key as you will need it in the next steps. | ||
| 8. To enable the Agentic UI Generator in a specific Blazor app, add a `.mcp.json` file to the solution folder. |
There was a problem hiding this comment.
Again, the context is insufficient. People now need to go back to Visual Studio and work there.
| #### Visual Studio | ||
|
|
||
| 1. Log in with a valid [Telerik user account](https://www.telerik.com/account/). | ||
| 2. Go to the [API Keys](https://www.telerik.com/account/downloads/api-keys) page in your Telerik account. If you already have an existing API key, you can skip steps 3-7 and continue from step 8, instead of creating a new key. |
There was a problem hiding this comment.
The second sentence here is weird. If people already have a valid API key, do they still need to log in their Telerik account?
|
|
||
| To enable global automatic discovery of the Agentic UI Generator in Visual Studio, add the above `.mcp.json` file to your user directory (`%USERPROFILE%`), for example, `C:\Users\____\.mcp.json`. | ||
|
|
||
| > Once the MCP server configuration is added, make sure that the `telerik-ui-generator` tool is [enabled (checked) in the Copilot Chat window's tool selection dropdown](https://learn.microsoft.com/en-us/visualstudio/ide/mcp-servers?view=vs-2022#configuration-example-with-github-mcp-server). This dropdown opens when clicking on a wrench icon 🔧 at the bottom of the Copilot Window. The Telerik Agentic UI Generator may get disabled when starting a new chat, changing threads, or relaunching Visual Studio. This is a known issue with MCP servers in general. |
There was a problem hiding this comment.
| > Once the MCP server configuration is added, make sure that the `telerik-ui-generator` tool is [enabled (checked) in the Copilot Chat window's tool selection dropdown](https://learn.microsoft.com/en-us/visualstudio/ide/mcp-servers?view=vs-2022#configuration-example-with-github-mcp-server). This dropdown opens when clicking on a wrench icon 🔧 at the bottom of the Copilot Window. The Telerik Agentic UI Generator may get disabled when starting a new chat, changing threads, or relaunching Visual Studio. This is a known issue with MCP servers in general. | |
| > Once the MCP server configuration is added, make sure that the `telerik-ui-generator` tool is [enabled (checked) in the Copilot Chat window's tool selection dropdown](https://learn.microsoft.com/en-us/visualstudio/ide/mcp-servers?view=vs-2022#configuration-example-with-github-mcp-server). This dropdown opens when clicking the wrench icon 🔧 at the bottom of the Copilot Window. The Telerik Agentic UI Generator may get disabled when starting a new chat, changing threads, or relaunching Visual Studio. This is a known issue with MCP servers in general. |
| #### Visual Studio Code | ||
|
|
||
| 1. Log in with a valid [Telerik user account](https://www.telerik.com/account/). |
There was a problem hiding this comment.
Same notes as for Visual Studio.
|
|
||
| #### Method 2: Using Natural Language | ||
|
|
||
| Prefixing your prompt with `#telerik_ui_generator` will make it more likely for the Agentic UI Generator to get called. Alternatively, you can use natural language and simply describe what you want. The AI assistant automatically recognizes when to use the Agentic UI Generator: |
There was a problem hiding this comment.
Angular recommend using kendo in the prompt to ensure the generator is being called. Do we have a similar rec for Blazor? (i.e., including telerik in the prompt)
|
|
||
| Here are some example prompts that demonstrate the capabilities of the Agentic UI Generator tools. | ||
|
|
||
| ### UI Generator Prompts |
There was a problem hiding this comment.
I recommend adding brief descriptions in each section of the targeted tools and possible use cases.
ai/ai-coding-assistant/overview.md
Outdated
| * The MCP server is more powerful and can handle more complex prompts that require several requests to the AI model. An MCP-enabled client like Cursor or GitHub Copilot in **Agent** mode can directly suggest changes to your app and even rebuild it to verify the new AI generated code. | ||
| * The responses of the GitHub Copilot extension may contain more explanations how to accomplish the task, and shorter or partial code snippets. When using the MCP server, the AI response is mostly code. | ||
|
|
||
| > [Microsoft is sunsetting GitHub Copilot extensions](https://github.blog/changelog/2025-09-24-deprecate-github-copilot-extensions-github-apps) on November 10, 2025, in favor of the Model Context Protocol (MCP) standard. |
There was a problem hiding this comment.
| > [Microsoft sunset GitHub Copilot extensions](https://github.blog/changelog/2025-09-24-deprecate-github-copilot-extensions-github-apps) on November 10, 2025, in favor of the Model Context Protocol (MCP) standard. |
Note to external contributors: make sure to sign our Contribution License Agreement (CLA) for Blazor UI first:
https://forms.office.com/Pages/ResponsePage.aspx?id=Z2om2-DLJk2uGtBYH-A1NbWxVqugKN5DvVp8I-1AgOBURFBVSkwyMlA1TkFDVFdMNU1aM1o1UlZQOC4u